home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / hdebug.exe / HDEBUG10.TXT < prev    next >
Encoding:
Text File  |  1991-10-20  |  4.0 KB  |  102 lines
  1.  
  2.                            HDEBUG.DOC
  3.                   Documentation for HDEBUG.PAS
  4.          (C) Copyright 1991, Brian D. Webb & P-Machinery
  5.                   Release 1.0, October 20, 1991
  6.  
  7.  
  8. These routines are just a stripped down version of a heap debugging package
  9. that I'm working on.  HEAP.TPU contains routines to intercept EVERY call to
  10. TP6's heap routines New(),Dispose(),GetMem(), and FreeMem(), including the
  11. new extended syntax for New() and Dispose().  Since the heart of these
  12. routines is the heap interceptor, I thought I'd send it out for a little
  13. beta testing while I iron out the bugs in the rest of the package.
  14.  
  15. These routines work for the IDE, Turbo Debugger, and standalone EXE files.
  16.  
  17. To intercept the heap routines, the variables HEAP.Allocation_Handler and
  18. HEAP.Deallocation_Handler need to contain the addresses of far routines of
  19. type Handler, which is:
  20.  
  21. type
  22.   Handler = Procedure(Size : Word; BlockAddr,CallAddr : Pointer);
  23.  
  24. The interceptor will pass along the size of the memory block, its address,
  25. and the address of the calling routine to the handler for error checking.
  26.  
  27. The unit HDEBUG10.PAS contains a generic handler which can flag the user
  28. whenever a potential fatal heap error has occured without exiting the
  29. debugging session.
  30.  
  31. The unit MAPINFO.PAS allows HDEBUG10.PAS to determine the unit and line
  32. number of the error.
  33.  
  34.  
  35.  
  36.  
  37. To use:
  38.  
  39. Include the units (Heap,HDebug10,MapInfo) in your uses clause.
  40.  
  41. In your main program, be sure to set MapFileName to the path name of the
  42. map file.  Also, be sure to compile to disk and generate a detailed map
  43. file.
  44.  
  45. To activate the heap interceptor, call the procedure HeapOn.
  46. To deactivate, call HeapOff.
  47.  
  48.  
  49. Please forward comments and criticisms to:
  50.    Brian D. Webb
  51.    76436,1131
  52.  
  53. If you need help really bad, give me a call at 713-427-0071
  54.  
  55.  
  56.          ----------------end-of-author's-documentation---------------
  57.  
  58.                          Software Library Information:
  59.  
  60.                     This disk copy provided as a service of
  61.  
  62.                            Public (software) Library
  63.  
  64.          We are not the authors of this program, nor are we associated
  65.          with the author in any way other than as a distributor of the
  66.          program in accordance with the author's terms of distribution.
  67.  
  68.          Please direct shareware payments and specific questions about
  69.          this program to the author of the program, whose name appears
  70.          elsewhere in  this documentation. If you have trouble getting
  71.          in touch with the author,  we will do whatever we can to help
  72.          you with your questions. All programs have been tested and do
  73.          run.  To report problems,  please use the form that is in the
  74.          file PROBLEM.DOC on many of our disks or in other written for-
  75.          mat with screen printouts, if possible.  PsL cannot debug pro-
  76.          programs over the telephone, though we can answer questions.
  77.  
  78.          Disks in the PsL are updated  monthly,  so if you did not get
  79.          this disk directly from the PsL, you should be aware that the
  80.          files in this set may no longer be the current versions. Also,
  81.          if you got this disk from another vendor and are having prob-
  82.          lems,  be aware that  some files may have become corrupted or
  83.          lost by that vendor. Get a current, working disk from PsL.
  84.  
  85.          For a copy of the latest monthly software library newsletter
  86.          and a list of the 3,000+ disks in the library, call or write
  87.  
  88.                            Public (software) Library
  89.                                P.O.Box 35705 - F
  90.                             Houston, TX 77235-5705
  91.  
  92.                                 1-800-2424-PSL
  93.                              MC/Visa/AmEx/Discover
  94.  
  95.                           Outside of U.S. or in Texas
  96.                           or for general information,
  97.                               Call 1-713-524-6394
  98.  
  99.                           PsL also has an outstanding
  100.                           catalog for the Macintosh.
  101.  
  102.